home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 2.iso / dist / fw_gnome-print.idb / usr / freeware / share / fonts / README.binaries.z / README.binaries
Text File  |  2002-07-08  |  3KB  |  105 lines
  1. Notes for binary package builders
  2.  
  3. Starting from thins version, gnome-print fontmap layout is
  4. much more flexible. This is mostly meant to make the life
  5. of package builders easier.
  6.  
  7. First you should read README.installer, to get the idea.
  8.  
  9. Most of 'make install' alchemy is just determining,
  10. whether and where user has installed fonts. Fortunately
  11. this should be no-problem for binaries, as you can rely
  12. on distribution-dependent font location.
  13. Also, there is no need for running font installer
  14. during package installation at all. if admin/user has
  15. specific fonts, it should be his/her responsibility to
  16. run gnome-font-install for those.
  17.  
  18.  
  19. So what should packagers do:
  20.  
  21. Once you have working gnome-print (font installer) in build
  22. machine, run installer once for each Type1 font package for
  23. given system (ghostscript-fonts, x11-fonts etc.):
  24.  
  25.   gnome-font-install --debug \
  26.                      --recursive \
  27.                      --clean \
  28.                      --static \
  29.                      --target=PACKAGENAME.fontmap \
  30.                      DIRS...
  31.  
  32. where DIRS are directories, where font files for given
  33. font package reside.
  34.  
  35. This will generate fontmap file, that contains entires for all usable
  36. Type1 fonts from given font package.
  37.  
  38. Then include PACKAGENAME.fontmap into binary distribution,
  39. installable to static fontmap directory (often /usr/share/gnome/fonts).
  40.  
  41. Better yet would be to include given fontmap with font
  42. package, so if user removes font package, fontmap will be
  43. removed as well. Alternately you should add
  44.  
  45.   test="some_font_file_from_package"
  46.  
  47. To <fontmap> node of generated file, so gnome-print can
  48. ignore full fontmap just by checking the presence of single
  49. file. Otherwise ghost fonts will appear in font parser, making
  50. users unhappy.
  51.  
  52.  
  53. IMPORTANT!!!
  54.  
  55. The only complex piece are urw/adobe chimaeric fonts. To
  56. generate fontmap for those, you have to do:
  57.  
  58. gnome-font-install --debug \
  59.                    --recursive \
  60.                    --clean \
  61.                    --static \
  62.                    --target=adobe-urw.fontmap \
  63.                    --aliases=PATH_TO_adobe_urw.font \
  64.                    DIRS_urw \
  65.                    DIRS_adobe_afms
  66.  
  67. Where adobe-urw.font is file from gnome-print (it will
  68. be installed by default, but there is no strict need
  69. to include it in binary).
  70. DIRS_urw are directories, where URW pfb files for fonts
  71. like NimbusSanL reside
  72. DIRS_afm are directories, where standard adobe afm
  73. files reside. Set of those are included with gnome-print
  74. installation, so you can use $datadir/fonts/afms
  75.  
  76.  
  77. Doing so, you can get rid of running font-installer
  78. during postinstall - what according to my experience is
  79. single most common point of failure with gnome-print
  80. binaries.
  81.  
  82. UPDATE: 05/11/2001
  83.  
  84. There is now --smart argument for gnome-font-install, that
  85. tries to do everything automatically. It's default scan paths
  86. are defined in gnome-font-install.c - feel free to add more,
  87. if these are common on your system.
  88.  
  89. The best way to do installing is now:
  90.  
  91. 1. Create and install prebuilt fontmaps
  92. 2. Run gnome-font-install --smart in postinstall.
  93.    It does additional search, and registers fonts, that users
  94.    may have in system, but are not included in prebuilt fontmaps.
  95.  
  96. Doing so guarantees, that even, if postinstall fails (I have
  97. encountered Type1 fonts that crash certain versions of FreeType),
  98. user still has set of standard fonts from prebuilt fontmaps.
  99.  
  100. have fun
  101. Lauris Kaplinski <lauris@ximian.com>
  102. 29.09.2001
  103.  
  104.  
  105.